Vehicle GPS Tracking

Introduction

This user manual provides a step-by-step guide on how to use the vehicle GPS tracking and cargo management system built with Frappe. The system allows users to track vehicle locations, record GPS updates, load and offload cargo, and interact with vehicle trip data in real-time. This guide is intended for users and administrators working with the GPS system.

1. System Requirements

Your GPS tracking devices are properly integrated with the Frappe system.

2. Recording Vehicle Position

The system tracks the real-time position of vehicles using GPS updates. It records data such as timestamp, location, longitude, and latitude, and associates these with vehicle trips.

Steps to Record a Vehicle Position:

• Enter the vehicle plate number to identify the vehicle.

• The system checks if the vehicle is in an ongoing trip (either "En Route" or "En Route - Returning").

• If the vehicle is part of an ongoing trip, it will:

     * Record the GPS update.
  
     * Save it under either main location update or return location update depending on the trip status.

Fetching the Last Known Vehicle Location

You can fetch the most recent location of a vehicle from the GPS device data.

Steps to Fetch Last Location:

• Input the vehicle plate number.

• The system connects to the server and queries the GPS device database for the latest location.

• If data is found, it updates the vehicle trip with the new GPS information.

4. Loading Cargo into a Vehicle

The system allows you to load cargo into a vehicle by updating the cargo details in the GPS tracking system.

Steps to Load Cargo:

• Provide the vehicle plate number.

• Input the date of loading, cargo type (e.g., COTTON), and the destination.

• The system will update the vehicle's cargo status to active and associate the loading details with the vehicle.

5. Loading Cargo into a Vehicle

The system allows you to load cargo into a vehicle by updating the cargo details in the GPS tracking system.

Steps to Load Cargo:

• Provide the vehicle plate number.

• Input the date of loading, cargo type (e.g., COTTON), and the destination.

• The system will update the vehicle's cargo status to active and associate the loading details with the vehicle.

6. Offloading Cargo from a Vehicle

When cargo is delivered, you can mark the vehicle as having offloaded the cargo.

Steps to Offload Cargo:

• Provide the vehicle plate number.

• The system will clear the cargo status, mark the vehicle as inactive, and reset the destination details.

7. Looping Through Vehicle List to Update Location

The system can loop through all vehicles and update their last known GPS location.

Steps to Loop Through Vehicles:

• The system fetches all vehicles from the database.

• For each vehicle, it retrieves the last location using the get last location function.

• This operation runs periodically to ensure vehicle locations are updated.